SimpleMail 2.20


Installation
============
Your Newton must be Internet Enabled before you can use SimpleMail; you need the
Newton Internet Enabler (NIE 1.1 or NIE 2.0). Follow the directions given to
download it to your MessagePad. If you don't already have the latest MessagePad
System Update, you should install that too.

Follow the directions in the NIE folder to set up a link to your Internet Service
Provider (ISP) using Internet Setup.

Installing SimpleMail is easy. Just download the SimpleMail.pkg package to your
MessagePad. SimpleMail 2.20 requires a "Text Stationery" extension to view text
messages in the In/Out Box and will install one automatically if it isn't already
in the Extras drawer's Extensions folder. Whilst SimpleMail will work with other
versions of the "Text Stationery" extension, for best results you should delete
any existing "Text Stationery" item from your Extensions folder before
downloading SimpleMail.

The Monaco.pkg contains a monospaced Monaco 9-point font good for
viewing messages in the In/Out Box - its use is optional.

If you install SimpleMail on a PC card, the SimpleMail transport will go away
when the card is removed and return when it is replaced. However, owing to a
"feature" of the approved installation process, SimpleMail will put the dreaded
"Grip of Death" on the card. For this reason it's recommended you install
SimpleMail on the Internal store.

Once you have transferred the package to the Newton, you will need to set up your
mail addresses in your Owner card. SimpleMail needs to know:

o  your e-mail address (for people to reply to)
o  your POP username & password for receiving mail
o  the addresses of your ISP's POP and SMTP hosts

Adding E-Mail information to your Owner card
--------------------------------------------
o  Tap the Owner Info application icon
o  Go to your owner card and tap Add.
o  In the list that appears, tap E-Mail
o  Enter the address people should reply to, for example simple@dial.pipex.com
   and set the type of address to E-Mail or Internet. Alternatively, if your ISP
   appears in the address picker, choose that and just enter your username in
   the address field.
   Ignore the "Set E-Mail Password" button.

You can add several E-Mail addresses to your owner card, but SimpleMail will use
only the first.

Adding SimpleMail information to your Owner card
------------------------------------------------
o  Tap the Owner Info application icon
o  Go to your owner card and tap Add.
o  In the list that appears, tap SimpleMail
o  In the slip that appears, enter the appropriate information:
o  In POP User enter your e-mail user name, for example bell99.
o  Tap the Set POP Password button and enter your POP e-mail password.
o  In POP Host enter the POP host's name, for example pop.isp.com.
o  In SMTP Host enter the SMTP host's name, for example smtp.isp.com.

If you have more than one mail account, for example at work or university and
home, you can add them all as SimpleMail items to your Owner card. SimpleMail
will check them all in turn when receiving mail, so you don't have to manually
connect to each one.

To summarise
------------
Your NIE Internet Setup holds the username and password used to log in to your ISP.
Your Owner card holds your e-mail address and ISP e-mail account information.


Use
===
Refer to the MessagePad Handbook, "using electronic mail".

If you have more than one e-mail address, remember to choose the appropriate
owner in the routing slip when you mail something. That way the recipient will
reply to the appropriate address.

When you reply to or forward a message, your e-mail address in the new message
will be the one which received the original message unless you change it in the
routing slip.


Removing messages from the server
=================================
You can remove individual received messages which you've left on the server.

o  Go to the e-mail message you received in the In Box, or check it in the overview.
o  Tap the Tag button and in the list that appears tap Remove.
o  The item is tagged "Remove".
o  Tapping the Tag button's Remove item again will revert the message's status.
o  Repeat the process for each message you want to remove.

Next time you receive SimpleMail, all items tagged "Remove" will be deleted from
the server. They'll remain in your Newton's In Box.


Preferences
===========
SimpleMail has a preferences slip, accessible by tapping the info button in the
in/out box. This will present a dialog that lets you:

X  Put away items automatically
   Available on Newton 2.1 only.
   When checked, puts away items to applications that can automatically receive
   them instead of adding them to the InBox.
   Otherwise leaves items in the InBox.

X  Leave mail on server
   When unchecked, deletes messages on the server after fetching them.
   Otherwise leaves them so they can be retrieved again.

X  Disconnect after sending
   When unchecked, automatically looks for new mail for your In Box after sending.
   Otherwise just disconnects after sending.

X  Strip Internet headers
   When unchecked, leaves messages intact.
   Otherwise removes internet addressing information from the start of received
   messages.

<> Retrieve items
   This picker lets you choose:
   o  what kind of items you want to receive
      o  New (unread) messages only
      o  Read messages only
      o  All messages (whether you've already read them or not)
         SimpleMail uses three independent methods to see whether you've read a
         message, but it's possible some servers won't support any of them.
         In this case you'll always get all messages on the server whether you
         want them or not.
   o  the maximum size of messages you want to receive in full. Messages over
      this size will be abbreviated to the first twenty lines. Choose "any size"
      to disable abbreviation.
NOTE -  If you haven't chosen to "Leave mail on server", messages are deleted
        from the server even if you've only got an abbreviated copy.

The About item in the preferences slip info button picker shows SimpleMail's
version.

The Mail Font button lets you choose the font for displaying your message text.
The enclosed Monaco.pkg contains a monospaced Monaco 9-point font well-suited to
this purpose. A fuller Minico font is also available.
After downloading it to your MessagePad you will be able to pick it from the Mail
Font button picker (and from the Styles palette).

The Auto Delivery button lets you set up your MessagePad to send anything in your
outbox and (so long as you haven't chosen to "Disconnect after sending") receive
messages automatically and unattended at times you specify.


Limitations & Known Problems
============================
You can mail notes and packages to other SimpleMail users, ie it's not just
text-only, but you can't mail packages to or from your Mac or PC (yet).

SimpleMail will not forward attachments.

SimpleMail can receive accented characters but does not send them.

On the MP2000 you can mail recorded notes, but you can't view them in the in/out
box. You have to Put Away a received recording to Notes to be able to play it
back.

If SimpleMail can't get unique ids for messages from the server, it will always
re-fetch messages left on the server and you won't be able to Remove them from
the server.

You can't Remove a message with New status whilst you're viewing it.


Frequently Asked Questions
==========================
Q: SimpleMail sends an attachment with every message, which recipients can't
read. How can I disable this "feature"?
--
A: The attachment is Newton data, readable by other SimpleMail users. For
example, you can mail a note including ink and sketches. If you want to send text
only, check the "Text Only" box in the routing slip when you mail a message.

Q: SimpleMail always fetches messages that aren't on my Newton. How can I stop it
re-fetching messages I've already read?
--
A: It's supposed to work this way; see "Preferences - Leave mail on server"
above. However, some servers don't provide the ids SimpleMail needs to identify
messages on the server, so they'll always be re-fetched. An option to ignore all
read messages will be available in a future version.

Q: When I try to connect I get a message saying "You need to set your owner
SimpleMail information before you can connect to the mail server." but I'm sure
it's all filled in correctly. What's missing?
--
A: You're probably not connecting as the right owner. The owner name shown in the
routing slip (top left corner) must be the one you've set up for SimpleMail. You
can run the Diagnostic package to check whether you really have set everything
correctly.

Q: When I'm trying to receive SimpleMail, everything seems okay until the status
slip says "Checking for mail" and then I'm alerted to a "POP -ERR". Why?
--
A: The POP host rejected your login information. Re-check your POP username and
password in the Owner card's SimpleMail setup slip.

Q: When I'm trying to receive SimpleMail, my modem just hangs up when the status
slip says "Looking up host...", but there's no error message. What's going on?
--
A: Your POP host couldn't be found on the net. Check the POP Host info in your
owner card.


Feedback
========
If you find some aspect of SimpleMail not up to snuff, or if you have helpful
suggestions, please feel free to let me know:

   Simon Bell <simple@dial.pipex.com>
   http://ds.dial.pipex.com/simple

SimpleMail is FreeWare! I want to make the Newton an even better place to live.
Pass it around, but please keep this ReadMe with the package.


Acknowledgements
================
Thanks and kudos go to Jason Harper for ViewFrame. Debugging has never been so
painless.


Legal
=====
While I have done extensive testing to make sure SimpleMail is well-behaved, I
cannot take responsibility for its use or misuse. If you don't like being
responsible for trying SimpleMail, don't!

SimpleMail was created and is owned by Simon Bell.
Apple, Newton and MessagePad are trademarks of Apple Computer, Inc.


1997-98 by Simon Bell
All Rights Reserved.
